home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / AMICUS / AMICUS03.ADF / Progs / disassem.doc < prev    next >
Text File  |  1986-04-02  |  3KB  |  100 lines
  1.       Instructions for Amiga memory disassembler
  2.          Copyright 1986 by LMR Software
  3.             8663 Ida Lane
  4.  
  5.     Sandy, UT 84092
  6.                 (801) 974-0992
  7.  
  8. This program is begining distrubuted as is to anyone who wants it.  Any 
  9. comments would be appreciated. Donations ($15) would be appreciated if
  10. you think this is useful to you. I would like to fix this up
  11.  and make it more useful, any encouragement would be helpfull.
  12.  
  13. Comments can be left on the Techni-Soft bulliten board at (801)
  14.  264-8290
  15. or by call me at the above number.
  16.  
  17. The file must be chopped to 12972 bytes (decimal) after you upload it before
  18. it will run.
  19.  
  20. Type disasm to enter the program. No paramaters are required
  21.  
  22. Valid commands are listed in the table below. Commands ma
  23. y be specified by their full names or any portion thereof.
  24.  The minimum that can be entered is the characters that are in upper case
  25.  in the table. The command table can be listed with the Help command.
  26.  
  27. Commands are:
  28. Help   print command formats
  29. EXIT   exit  to 
  30. Mem   dump memory contents in hex and ascii
  31. List   list disassemble instruction from memory
  32. DUAL   open a second channel for dual output
  33.  
  34. Display commands (mem/list) may have optional parameters.
  35. Options are starting address followed by either a count or end address.
  36. Preceede a count value with a +.  
  37. These commands may be continued from where they stop by giving the command
  38. again or simply by hitting the space bar. These are repeat type commands.
  39.  
  40. Dual is used to open a second output channel so that the data can be
  41. saved for later use. 
  42. Example: dual ram:dis.out
  43.    will open a file on the ram disk called dis.out and send a copy
  44.    of the output there. The output can be turned off by entering
  45.    dual off. It can be turned on later with just a dual on command.
  46.    This can be done while you look around for more interesting
  47.    stuff to save. Commands are not written to the output.
  48.  
  49. For some reason the prt: device cannot be open for the second channel.
  50. So for now use a disk file and then print it.
  51.  
  52. If you use a disk file you can also edit it and add comments before
  53. you print it.
  54.  
  55. Comments can also be sent to the output file by preceding the line
  56. with a semicolon.
  57.  
  58. I have included a sample output from the disassembler in file "exec.lvo".
  59. This file has all of the LVO jump's for Amiga exec program. It also
  60. has all the data from the ExecBase structure.
  61.  
  62. All input numbers default to hex.
  63.  
  64.  to specify a decimal number preceede it with a . (decimal point)
  65.  
  66. Valid numbers are as follows:
  67.    $nn - $ symbol for hex number ala assembly 
  68.    0xnn - 0x for hex number ala 'C'
  69.    .nn - preceding decimal point for decimal numbers
  70.    'cc' - ascii char inside single quotes
  71. any numbers not preceded by one of the above must start with a digit(0-9)
  72.  
  73.  
  74. Numbers may be a complex expression if desired, with paranthesis and the 
  75. following operators:
  76. | - bitwise OR
  77. & - bitwise AND
  78. ^ - bitwise XOR
  79. + - sum
  80. - - difference
  81. * - multiply
  82. / - divide
  83. % - modulo
  84. - - unary minus
  85. ~ - unary not
  86. * - unary pointer( uses number at expression )
  87.  
  88. All operators obey normal precedence rules as defined by 'C'
  89.  
  90. example: m *(*4+114) 
  91.    will display the memory for the task control block
  92.  
  93.   of the currently running task.
  94.  
  95. I hope you find this program usefull
  96.  
  97.          Lee M. Robertson
  98.  
  99.  
  100. l